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1. SCOPE 


This document describes the programs which together provide 
the capability of producing scatter plots in two different 
projections for use by CAMS in implementing the direct wheat 
procedure . 
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2 . APPLICABLE DOCUMENTS 


1. Giddings, L. E.; etal. 

"As-Built" Desir.n Specification for the CAMS Image-100 Hybrid 
System. August 1977 Job Order 71-195, LEC-10822, Contract 
NAS-9-15800. 

2. Earth Resources Data Format Control Book, Vol 1 Section 6 
PHO-TR543. 

3. CAMS /CAS Interface Tape Interface Control Document (Rev. B) 
Feb 1978 LAC IE - C00708 (Rev. B) JSC-11328. 

4. Software Requirements for Scatter Plots to Aid With Direct 
Wheat Procedures (TIRF 78-0027) 5/18/78. 

5. Large Area Crop Inventory Experiment (LAC IE) Users Giiide 
Vol IBM - Federal Systems Division Contract NAS 9-14350. 

6. TIRF 79-0001, Landsat "C" Upgrade to "CAMPLT" . I 
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3. SYSTEM DESCRIPTION 


3.1 HARDWARE DESCRIPTION 
Not applicable. 

3.2 SOFTWARE DESCRIPTION 

The programs described herein provide the capability to load 
the spring wheat data file with spectral values from spectral 
unload tapes , and analyst labels from CAMS/ CAS Interface tapes, 
then, under analyst control, produce spectral plots using this 
data. These programs are run separately in batch mode. 




3.2.1 SOFTWARE COMPONENT NO. 1 (DOTLDB) 


The program DOTLDB (DOT LOAD BATCH) reads a spectral unload 
utility tape and stores the spectral values found there for 
the 209 grid points in the Spring Wheat Data File. This data 
is loaded in 'natural' dot order. 
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Figure 1 Data Flow 












3 . 2 . 1 . 1 Linkages 

DOTLDB run in batch moda. It calls several entries to LECTAPi 
EBTA8C , I DATE, SWAB, TATCH, TFILE, TIME, TINIT, TREAD, TRWD, 
TWA IT (ref .1) 

In addition it calls STORX. 

3. 2. 1.2 Interfaces 

Entries to LECTAP interface through the calling sequence and 
and through labeled common /STATUS/. 

The interface to STORX is through the calling sequence and the 
labeled common /ANCIL/. 

3. 2. 1.3 Inputs 

DOTLDB is run in batch mode by the following deck: 

^ATA NAMfc “ CAMb/WtK/ACCUUNTclft O * b0 

0 0 999 

*fcUU 

*MCK KUN DU I L Utt 

seuj 


DOTLDB reads a spectral unload utility tape from the ERIPS 
system. A spectral unload utility tape is in universal format. 
The header is identical to the usual image unload tape header. 
The image is replaced with spectral values for the 209 grid 
points. One tape may contain 1000 acquisitions. DOTLDB will 
handle 999 acquisitions. 

3. 2. 1.4 Outputs 

DOTLDB creates a report on the line printer reporting each 
segment loaded to the Spring Wheat Data File (fig2 ). 
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The spectra^ values for 209 points are passed to STORX to be 
itored in (200 ,7) DOTDATA. ACA under the code 'SWCHJ' where 
j»l, . ..,4 is the channel number, with the acquisition date 
for date (DAT (1) , DAT ( 2 ) ) . 

3 . 2 . 1 . 5 Storage 

Total space allocated ■ 6727. 

3. 2. 1.6 Description 

DOTLDB first reads the batch deck to identify the tape drive 
used and the number of acquisitions to be loaded. It then 
initializes the tape drive and starts processing. The processing 
is accomplished in a DO Loop which reads the header, obtains the 
segment number and date, then reads the dot data. The dot data 
is loaded into 4 linear arrays (CHJ(209), J«l,4) in natural 
order, not the order implied by the (11,19) dimensioning in STORX, 
and passed to STORX for storing. After this processing, is 
comp let for all acquisitions, the tape is rewound and a line 
printer report is created. 

3. 2. 1.7 Flowchart 

Not applicable. 

3.2. 1.8 Listing 
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3.2.2 SOFTWARE COMPONENT NO. 2 (SWLOD) 


SWLOD (Spring Wheat Load) reads a CCIT tape and, for each spring 
wheat segmunt, loade the .vicr/st dot labels into the Spring 
Wheat Data File. 

3 . 2 . 2 . 1 Linkages 

SWLOD runs in batch mode from a deck. It calls CDRED and 
LABLOD* CDRF D is documented in (ref.l). 

3. 2. 2. 2 Interfaces 

SWLOD and LABLOD interface with CDRED through the calling 
sequence and the labeled commons /CBIAS/, /DUMMY / , /CLCOM/ . 
These are implemented by the statement INCLUDE 'COMMONl.DAT'. 

3. 2. 2. 3 Inputs 

The batch deck for SWLOD is: 

* JUH/NAMt* CAfob/ MLK/ AC WJUWT = it>0 ?bU 
$Da TA 
M 
1 

$hjl> 

*MCK KUN bWLUU 
*HUJ 


SWLOD reads a standard LACIE 7 CAMS-CAS interface tape. Full 
description of this tape can be found in (ref.). 

3. 2. 2. 4 Outputs 
None. 

3. 2. 2. 5 Storage 

Total space allocated - 8015. 
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3 . 2 . 2 . 6 Description 

SWLOD is the driver for the program which loads analyst labels 
to Spring Wheat Data File. CDRED on first calling, determines 
from the batch deck, which tape unit to read. CDRED then reads 
one record. SWLOD tests each record to determine whether it is 
a header record or an End Of File record. For header records, 
segment number and spring wheat marker are obtained. If the 
spring wheat marker is 'S', then LABLOD is called when a 'D' 
record is found. 

3. 2. 2. 7 Flowchart 


Not applicable. 


3. 2. 2.8 Listing 
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3.2.3 SOFTWARE COMPONENT 3 (LABLOD) 

LABLOD (LABEL LOAD) calls CDRED to get all analyst labels, puts 
them In an (11,19) array, passes them to STORX for storage and 
writes a line of the report. 
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3. 2. 3.1 Linkage 

Subroutine LABLOD la cal lad by SWLOD each tima a spring wheat 
fila is found on tha CCZT. It calls CORED and STORX. 

3 . 2 . 3 . 2 Intarfac as 

Interfaces with SWLOD and CORED are the calling sequence and 
labeled commons /CBIA S/, /DUMMY/ , /CLCOM/. 

Interface with STORX is through the calling sequence and the 
labeled common /ANCIL/. 


3. 2. 3. 3 Inputs 

All Inputs ars through ths calliVj subroutines. 

3. 2. 3. 4 Output 

The analyst labels are passed to 'STORX' under the code name 
' SWDAFI * (i'or Spring Wheat Data Pile) with the fixed date 
78,000. The fixed date means only the most recent labels are 
accessable . 

For each batch of labels loaded, one line of printer output i 
generated . 









3. 2. 3. 5 Storage 

Total space all>cated - 6873 


3. 2. 3. 6 Paacrlptlon 

LABLOD first sats tha storage data to 78,000. It than loads and 
reads analyst dot labels into an array which is (11,19). This 
is not tha natural dot order. Having loaded ell tha dot labels, 
they are passed to STORX for storage under the code 'SWDAFI' 
at date 78,000. Thon control is passed back to SWLOD. 

3. 2. 3.7 Flowchart 


Not applicable. 


3. 2. 3. 8 Llatl Tg 
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3.2.4 SOFTWARE COMPONENT 4 (STORX) 

STORX is identical to the program STORE except that the Spring 
Wheat Data File [200,7] DATDATA.ACA is accessed rather than 
a local file. 


3.2.5 SOFTWARE COMPONENT 5 (CAMPLT) 


CAMPLT runs in batch mode from a deck supplied by FLOCON when 
requested by a CAMS analyst. It accesses the spring wheat data 
file and creates spectral plot output which is given to the 
analyst. 


3 . 2 . 5 . 1 Linkages 

CAMPLT runs in batch mode. It calls FETCX and Su/PLT 

3. 2. 5. 2 Interfaces 

CAMPLT interfaces with FETCX through the calling sequence 
and through the labeled common /ANCIL/ . 

CAMPLT interfaces with SWPLT through the calling sequence and 
through the labeled commons /GRAPH/ and /PLOT/. 


3 . 2 . 5 . 3 Inputs 

CAMPLT reads the FLOCON supplied analyst deck (fig)^. 

CAMPLT reads the data file [200,7] SOIL.DAT to get the estimated 
soil greenness value. 

CAMPLT obtains spectral values for the dots from the spring 
wheat data file through FETCX. 

3. 2. 5. 4 Outputs 

Output from CAMPLT is as follows: 

1. Listing of the dots in natural order with labels, dot 
identif ication^ and green number, brightness coordinates. 

2. Listing of the dots in green number order with labels, dot 
identification and green number, brightness coordinates. 
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3. Plot of the dots in Brightness, Green number, plotting 
character is analyst label, or number of hits. 

4. Density plot, more hits plot darker, in Brightness, Green 
number. 

5. Listing of the 209 plotting labels in a 19 by 11 grid. 

6. Identical to l)-4) except Brightness, Green Number are 
replaced by OLPARS derived coordinates. 

3 . 2 . 5 . 5 Storage 

Total space allocated = 9953. 

3. 2. 5. 6 Description 

CAMPLT first reads the batch input deck. From the first GRAPH 
card read it obtains the segment number, acquisition date, 
satellite identification, and a flag to user or not use previous 
analyst labels. From each DOT card it gets a valid plotting 
symbol and optionally, a listing of dots to plot with this 
symbol. A second GRAPH card, a STOP card, or an end of data 
initiates processing. A second GRAPH card sets a flag which 
continues processing after the first segment is processed. 

In further processing, the first step is to read soil cards 
until a match for segment and date is found. If no match is 
found, the last one is used and a message typed. 

Then, if previous analyst labels are to be used, they are 
retrieved by FETCX. These labels are used to label any dot not 
previously labeled by a DOT card. 

Next the spectral values are retrieved from the Spring Wheat 
Data File by FETCX, (calibrated if satellite is Landsat 3,) 
and transformed to the plotting values. Unfortunately, space 
limitation required the destruction of these spectral values 
through an equivalence statement. 
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With all the data in the machine, the next step prints the data 
in natural order. Then the data is put in green number order 
and printed. 

Now the plotting starts. First the correct potting character 
for each dot is defined. For the first plot only characters 
from Dot cards are plotted. *N # is plotted as ' multiple hits 
are plotted as numbers. For the second plot, the same dots are 
plotted with different characters. After these plotting 
characters are defined, SWPLT is called to do the actual plotting. 


Then the labels are printed in grid position, OLPARS weightings 
are initialized and the OLPARS loop is started. 

In case a second segment card initiated processing, after the 
OLPARS plot is made, the program loops to the beginning. 
Otherwise it stops. 

3. 2. 5. 7 Flowchart 
The Flow chart follows. 


3. 2. 5. 8 Listing 
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The program from whieh CAMPLT grow had tha wrong format for the 
plots. swplt was added to do tha plotting in tha corract format. 
There ara many imusad statements in 8MPLT. 

3.2. 6.1 Llnkaqos 

SWPLT is cal lad by CAMPLT aftar tha plotting characters ara 
dafinad. 


3.2. 6. 2 Intarfacaa 

8WPLT intarfacaa with CANPLT through tha calling sequence and 
tha labeled commons /GRAPH/ and /PLOT/. 

3. 2. 6. 3 Inputs 

All inputs for SMPLT ara from CAMPLT. 

3. 2. 6. 4 Outputs 

SWPLT creates the actual line printer plot. The headings are 
created by CAMPLT. 

3. 2. 6. 5 Storage 

* 

Total space allocated * 5073 

3. 2. 6. 6 Description 

SWPLT clears the graph array, enters the plotting characters, 
and writes the graph to the line printer. 

3. 2. 6.7 Flowchart 

Not applicable. 

3. 2. 6. 8 Listing 
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3.2.7 SOFTWARE COMPONENT 7 (FETCX) 

PETCX it identical to FETCH except that it aecassas [200,7] 
dotdata.aca rather than a local file. FITCH ie an undocumented 
utility. 


4. OPERATIC* 


■aeh module in this system is run by a batch deck. PLOCON has 
copies of these decks. Maintenance and generation of the data 
files is not addressed in this document. 
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